package com.expert.miniapp.service;

import com.expert.miniapp.dao.Demand;

/**
 * AIDemandSummaryService - AI需求摘要生成服务接口
 *
 * 提供需求摘要自动生成功能，调用独立的Summary AI端点
 *
 * @author System
 * @since 2025-11-11
 */
public interface AIDemandSummaryService {

    /**
     * 为需求生成AI摘要
     *
     * 根据需求的各项信息（需求名称、研究目标、技术领域、核心技术挑战等）
     * 调用AI API生成专业的需求摘要
     *
     * @param demand 需求对象，包含完整的需求信息
     * @return 生成的摘要文本
     * @throws RuntimeException 当AI生成失败时抛出异常（经过重试后仍失败）
     */
    String generateDemandSummary(Demand demand);
}
